home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / xbtx.lha / XBTX.doc < prev   
Text File  |  1995-12-03  |  7KB  |  176 lines
  1. TABLE OF CONTENTS
  2.  
  3. XBTX/XBTX
  4. XBTX/XBTX                                                           XBTX/XBTX
  5.  
  6.    NAME
  7.        XBTX -- BTX/Datex-J decoder (V39)
  8.  
  9.    SYNOPSIS
  10.        DEVICE/K,UNIT/K/N,BAUD/K/N,RTSCTS/K,INIT/K,DIAL/K,NUMBER/K,HANGUP/K,
  11.            FILE/K,SCALEX/K/N,SCALEY/K/N,TEXT/S,SCREEN=PUBSCREEN/K,DIRECT/S,
  12.            TIMEOUT/K/N
  13.  
  14.    FUNCTION
  15.        XBTX is a BTX/Datex-J decoder developed by Arno Augustin and
  16.        Frank Höring at the University of Erlangen-Nuremberg, Germany.
  17.        This Amiga version is based upon the original X-Windows
  18.        implementation, it adds Telesoftware 3-in-4 and FIF format
  19.        download capabilities, including RLE and LZH decompression.
  20.        In addition to this, v1.7 supports the 8 bit transparent mode
  21.        data link and presentation layer options required by KIT.
  22.        There is still no KIT support in this program, though.
  23.  
  24.    REQUIREMENTS
  25.        XBTX requires Amiga operating system v3.0 or higher, an Amiga
  26.        equipped with at least an MC68020 CPU and if possible video
  27.        hardware capable of displaying at least 60 distinctly different
  28.        colours. If XBTX is unable to allocate at least 60 colours for
  29.        use, it will fall back to a text-only display. Your Amiga better
  30.        be real fast, as the BTX font conversion routines are dog slow.
  31.        XBTX must be started from Shell, it does not run from Workbench yet.
  32.  
  33.    INPUTS
  34.        DEVICE/K
  35.            Amiga device driver to use, default is "serial.device".
  36.  
  37.        UNIT/K/N
  38.            Amiga device unit number to use, default is 0.
  39.  
  40.        BAUD/K/N
  41.            Baud rate to use; if not specified the default baud rate
  42.            of the device driver will be used.
  43.  
  44.        RTSCTS/K
  45.            Turn RTS/CTS handshaking on or off; if not specified the
  46.            default hardware handshaking mode of the device driver
  47.            will be used.
  48.  
  49.        INIT/K
  50.            Modem initialization command, default is "ATE1V1Q0^M".
  51.  
  52.        DIAL/K
  53.            Modem dialing command to use, default is "~~ATD".
  54.  
  55.        NUMBER/K
  56.            Phone number to dial in order to connect to the Datex-J
  57.            service, default is "01910".
  58.  
  59.        HANGUP/K
  60.            Modem hang up command to use, default is "~~+++~~ATH0^M".
  61.  
  62.        FILE/K
  63.            Name of prerecorded file to playback.
  64.  
  65.        SCALEX/K/N
  66.            Factor by which to scale the display in the horizontal
  67.            direction, must be between 1 and 8; default is 1. This
  68.            only works with the graphics display.
  69.  
  70.        SCALEY/K/N
  71.            Factor by which to scale the display in the vertical
  72.            direction, must be between 1 and 8; default is 1. This
  73.            only works with the graphics display.
  74.  
  75.        TEXT/S
  76.            Use the text-only display.
  77.  
  78.        SCREEN=PUBSCREEN/K
  79.            Open the display on the named public screen.
  80.  
  81.        DIRECT/S
  82.            Build screen characters directly on the screen, do not use
  83.            a temporary offscreen buffer. Will save some memory and may
  84.            increase on-screen rendering speed, but then maybe not.
  85.  
  86.        TIMEOUT/K/N
  87.            Set the modem dial timeout (in seconds), default is 120
  88.            seconds. You may want to change this value if the dialer
  89.            responds with a timeout message after the modem has made
  90.            a connection. Please note that the timeout accounts for
  91.            the entire login procedure, starting with the modem getting
  92.            initialized, following the dial command, ending with the
  93.            modem making the connection and picking up the carrier
  94.            signal.
  95.  
  96.    MODEM COMMANDS
  97.        You can include simple control sequences in the modem commands.
  98.        The tilde (~) causes a delay of about a second. Prefixing a
  99.        character with a caret (^) will turn it into a control code,
  100.        for example ^M gives a carriage return (or Control-M).
  101.  
  102.    EXAMPLE
  103.        Dial into the fast modem service with RTS/CTS handshaking
  104.        enabled:
  105.            xbtx rtscts=on number=051119304
  106.  
  107.        Dial into the slow modem service with RTS/CTS handshaking
  108.        disabled:
  109.            xbtx rtscts=off
  110.  
  111.        Open a text-only display on the `term' public screen:
  112.            xbtx text screen=term
  113.  
  114.    ENVIRONMENT VARIABLES
  115.        In place of command line options, you can store your default
  116.        XBTX options in an environment variable "XBTX.setup". Please
  117.        note that if you set the variable, XBTX will completly ignore
  118.        all command line options.
  119.  
  120.    NOTES
  121.        This software has not been validated or approved by the
  122.        "Bundesamt für Zulassungen in der Telekommunikation" of the
  123.        "Deutsche Bundepost Telekom" and thus must not be used for
  124.        accessing the BTX-Network of the Telekom in Germany. It is
  125.        provided solely for educational purposes only.
  126.  
  127.        This software is provided by the authors "as is" and any
  128.        express or implied warranties, including, but not limited
  129.        to, the implied warranties of merchantability and fitness
  130.        for a particular purpose are disclaimed. In no event shall
  131.        the authors be liable for any direct, indirect, incidental,
  132.        special, exemplary, or consequential damages (including,
  133.        but not limited to, procurement of substitute goods or
  134.        services; loss of use, data, or profits; or business
  135.        interruption) however caused and on any theory of
  136.        liability, whether in contract, strict liability, or tort
  137.        (including negligence or otherwise) arising in any way out
  138.        of the use of this software, even if advised of the
  139.        possibility of such damage.
  140.  
  141.        You have been warned, kids.
  142.  
  143.  
  144.        Incidentally, this is my first major attempt at C++
  145.        programming. Any changes I made to the code are
  146.        really © Copyright 1995 by Olaf Barthel.
  147.  
  148.        There is no KIT support in this program. Feel free to add it.
  149.  
  150.    BUGS
  151.        The font decoding and output routines are neither blazingly
  152.        fast, nor shockingly well designed, but they get the job
  153.        done. Flashing characters are not supported (yet).
  154.        Concealed characters are always revealed, there is no option
  155.        to keep them concealed.
  156.  
  157.        Up to, but not including v1.7, XBTX did not transmit the
  158.        special key control codes for *, #, etc. correctly. In fact
  159.        they would get transmitted twice. The data link layer was
  160.        getting into big trouble if low baud rates were being used.
  161.  
  162.    AUTHORS
  163.        Arno Augustin, University of Erlangen-Nuremberg,
  164.            <aoaugust@cip.informatik.uni-erlangen.de>
  165.  
  166.        Frank Höring, University of Erlangen-Nuremberg,
  167.            <fkhoerin@cip.informatik.uni-erlangen.de>
  168.  
  169.        Olaf Barthel (Amiga port)
  170.            <olsen@sourcery.han.de>
  171.  
  172.    SEE ALSO
  173.        "Functional Specification for BTX-Terminals", DBP Telekom
  174.        xbtx - a Bildschirmtext-decoder for the X-Window system
  175.  
  176.